═══ 1. Legal Notice ═══

Copyright (C) 1997 James R. Louvau This program is free software; you can 
redistribute it and/or modify it under the terms of the GNU General Public 
License as published by the Free Software Foundation; either version 2 of the 
License, or (at your option) any later version. This program is distributed in 
the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the 
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See 
the GNU General Public License for more details. You should have received a 
copy of the GNU General Public License along with this program; if not, write 
to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 
02111-1307, USA. You may contact the author of PMLPP at: E-mail : jim@vwm.com 
Snail-mail : Jim Louvau 3437 335th St. West Des Moines, IA 50266 


═══ 2. Overview ═══

PMLPP's main window consists of three main elements: 

   1. A pushbutton/icon. 

   2. A message-count display window. 

   3. A popup/context menu. 

 Note:  You can drag the main window by clicking and holding either mouse 
 button. 


═══ 2.1. Refresh Button ═══

Clicking on the refresh button results in one of two actions. If you have 
defined a mailreader, and there is mail pending, PMLPP will attempt to launch 
your reader. Failing that, PMLPP will poll the server immediately if possible. 
The icon background of the button will also reflect PMLPP's current status. If 
the background is GRAY, there is no mail on the server. If GREEN, one or more 
messages are available. If RED, something has malfunctioned (see Error Codes). 


═══ 2.2. Message Count Window ═══

This is the small window below the refresh/icon button. One of two things will 
appear here; a message count as of the last poll, or an error code. 


═══ 2.3. Context Menu ═══

PMLPP uses a combination system and context/popup menu. Clicking the 
context-menu mouse button (usually button 2 or the right one) anywhere over the 
main window will bring up the menu. Use the "Properties" option to open a 
configuration dialog. 


═══ 3. Configuration ═══

The following options are available for configuring PMLPP: 

      Play Sound. 

      Minutes. 

      Server. 

      Port. 

      User. 

      Password. 

      Program. 

      Options. 

      Directory. 


═══ 3.1. Play Sound ═══

If this box is checked, PMLPP will beep ONCE when it detects the first message; 
i.e., when the message count changes from 0 (zero) to 1 (one). 


═══ 3.2. Seconds ═══

"Click" on the arrow-buttons or type in the number of SECONDS PMLPP should 
pause between polls to the pop server. 

Note:  The valid range is 1 to 86400 (24 hours). 


═══ 3.3. Server ═══

Your pop server's address as a domain name like: 

mail.mydomain.com
or as an I.P. address like: 

167.142.225.5


═══ 3.4. Port ═══

The POP3 "service" port (usually 110). 

Note:  If set to 0 (zero), PMLPP will look up the appropriate value in your 
host's "services" file. This is your best bet for staying out of trouble. 


═══ 3.5. User ═══

You, silly! The name you use to logon to the pop server. 

CAUTION:
Your user name is almost always CASE SENSITIVE! 


═══ 3.6. Password ═══

The password you use to logon to the pop server. 

CAUTION:
As with your user name, passwords are almost always CASE SENSITIVE! 


═══ 3.7. Save Password ═══

If this box is checked, PMLPP will save your password in its INI file, where 
somebody could conceivably see it (INI files are binary, but text in strings is 
visible). If left unchecked, you will be prompted for your password when PMLPP 
is launched. 


═══ 3.8. Force IP ═══

If this box is checked, and you have entered a (numerically) valid I.P. address 
in the server field, PMLPP will ignore any errors returned from DNS lookup, and 
attempt to use this I.P. address. In other words, YOU are assuming 
responsibility for the correctness of the address. 


═══ 3.9. Program ═══

The pathname of your mail-reader program. You only need to set this if you 
would like to be able to launch your mail-reader from PMLPP's menu. 


═══ 3.10. Options ═══

Command-line option to pass to the reader, if any. 


═══ 3.11. Directory ═══

What directory to change to before running the reader. 


═══ 4. Error Codes ═══

The following codes may appear in the "message count" window: 

 ADDR 

           PMLPP was unable to resolve the server name/address (gethostbyname() 
           and/or gethostbyaddr() failed). 

 SOCK 

           PMLPP was unable to obtain a new socket from the system (socket() 
           failed). 

 CONN 

           PMLPP was unable to connect to the server (connect() failed). 

 SRVR 

           The server won't talk to PMLPP. It isn't running, or for some reason 
           (it's too busy, etc.) refuses to accept commands (we timed out 
           waiting for it to "talk" to us, or the server didn't respond with 
           "+OK"). 

 USER 

           The server has rejected your user name; i.e., it doesn't like you or 
           doesn't know who you are. Make sure you've configured your name 
           correctly. 

 PASS 

           The server has rejected your password. Make sure you've entered it 
           correctly. 

 STAT 

           The server doesn't want to give us statistics. You should NEVER see 
           this, and if you do, it probably means something on the server end 
           is broken. 

 VALU 

           PMLPP couldn't parse the statistics string returned by the server. 
           You should never see this either. 


 Note:  Some of the above error codes may appear erroneously if something 
 happens to the connection in mid "conversation." In other words, you might see 
 a "PASS" error if PMLPP was waiting for the server to acknowledge your 
 password, and the connection was suddenly broken.